Summary

Keeps the dbt MetricFlow integration page in sync with the CLI's native MetricFlow translation as it grows: initial coverage for simple metrics, then ratio/derived/filter/sum_boolean translation, then config.meta passthrough. Also cross-links the page from the Metrics reference.

Changes

• references/integrations/dbt-metricflow.mdx
  • Requirements subsection: dbt Core 1.6+ (manifest v10), CLI-only (server-side translation on the roadmap).
  • Documented ${TABLE} qualification of bare-column expr values.
  • Documented percentile-value normalization between the legacy 0–1 fraction and the latest 0–100 scale, and that percentile measures without a numeric value are skipped.
  • Supported features table now covers agg: sum_boolean, same-model filter: (as CASE WHEN), same-model ratio metrics (as a number metric with NULLIF-guarded division), and same-model derived metrics.
  • Added a "Notes on filters, ratio, and derived metrics" section explaining same-model requirements, filtered inputs compiled to hidden helpers, and skipped time-offset inputs.
  • Documented config.meta.hidden and config.meta.group_label passthrough on measures and metrics.
  • Rewrote the "not supported yet" table to reflect the current gap set (cumulative / conversion, cross-model ratio/derived inputs, offset_window / offset_to_grain, non-Dimension() filter templates).
  • Expanded the illustrative ecom YAML example to demonstrate create_metric: true, config.meta passthrough, a same-model filter, and a ratio metric.
• references/metrics.mdx
  • Callout in "Adding metrics to your project" pointing MetricFlow users to the integration page so they don't duplicate metrics in meta.metrics.

Context

Reflects three CLI changes:

• feat(cli): native dbt MetricFlow metric support on deploy lightdash#25478 — initial native MetricFlow translation on deploy.
• feat: support MetricFlow ratio/derived metrics and same-model filters lightdash#25594 — ratio / derived metrics and same-model filters.
• feat(metricflow): carry config.meta hidden and group_label into translated metrics lightdash#25607 — config.meta.hidden / group_label passthrough.

Update history

• Initial pass: documented native MetricFlow translation of simple metrics — dbt Core 1.6+ requirement, CLI-only availability, ${TABLE} qualification, percentile normalization, skip cases, and a cross-link from the Metrics reference (feat(cli): native dbt MetricFlow metric support on deploy lightdash#25478).
• Follow-up: expanded the supported-features table to cover ratio, derived, same-model filters, sum_boolean, and config.meta.hidden / group_label passthrough; refreshed the not-supported list to the current gap set (cross-model inputs, offset_window / offset_to_grain, non-Dimension() filter templates); grew the example YAML to show a filter, a ratio metric, and config.meta.group_label (feat: support MetricFlow ratio/derived metrics and same-model filters lightdash#25594, feat(metricflow): carry config.meta hidden and group_label into translated metrics lightdash#25607).